Carbon


GetThemeTrackLiveValue

Header: Appearance.h Carbon status: Supported

Obtains the current value of a track’s indicator, given its relative position.

OSStatus GetThemeTrackLiveValue (
    const ThemeTrackDrawInfo *drawInfo, 
    SInt32 relativePosition, 
    SInt32 *value
);
drawInfo

A pointer to a structure of type ThemeTrackDrawInfo. Before calling GetThemeTrackLiveValue, set the structure to contain the current visual characteristics of the track.

relativePosition

A signed 32-bit value. Pass the distance, in pixels, between the minimum end of the track and the near side of the indicator. You may obtain this value by calling either of the functions GetThemeTrackThumbPositionFromOffset or GetThemeTrackThumbPositionFromRegion.

value

A pointer to a signed 32-bit value. On return, this value contains the new value of the indicator.

function result

A result code.

DISCUSSION

Your application can use the GetThemeTrackLiveValue function to respond to the posCntl and kControlMsgCalcValueFromPos control definition message.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)